Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 1 - Introduction to QuickDraw 3D

Summary of QuickDraw 3D

C Summary

Constants

Gestalt Selector and Response Values

enum {
   gestaltQD3D                      = 'qd3d',
   gestaltQD3DNotPresent            = 0,
   gestaltQD3DAvailable             = 1
}

Basic Constants

typedef enum TQ3Boolean {
   kQ3False,
   kQ3True
} TQ3Boolean;
typedef enum TQ3Status {
   kQ3Failure,
   kQ3Success
} TQ3Status;
typedef enum TQ3Axis {
   kQ3AxisX,
   kQ3AxisY,
   kQ3AxisZ
} TQ3Axis;

QuickDraw 3D Routines

Initializing and Terminating QuickDraw 3D

TQ3Status Q3Initialize(void);
TQ3Status Q3Exit(void);
TQ3Boolean Q3IsInitialized(void);

Getting Version Information

TQ3Status Q3GetVersion(unsigned long *majorRevision,
unsigned long *minorRevision);

Managing Sets

TQ3SetObject Q3Set_New(void);
TQ3ObjectType Q3Set_GetType(TQ3SetObject set);
TQ3Status Q3Set_Add(TQ3SetObject set, 
TQ3ElementType type, 
const void *data);
TQ3Status Q3Set_Get(TQ3SetObject set, 
TQ3ElementType type, 
void *data);
TQ3Boolean Q3Set_Contains(TQ3SetObject set, TQ3ElementType type);
TQ3Status Q3Set_GetNextElementType (
TQ3SetObject set, TQ3ElementType *type);
TQ3Status Q3Set_Empty(TQ3SetObject target);
TQ3Status Q3Set_Clear(TQ3SetObject set, TQ3ElementType type);

Managing Shapes

TQ3ObjectType Q3Shape_GetType(TQ3ShapeObject shape);
TQ3Status Q3Shape_GetSet(TQ3ShapeObject shape, TQ3SetObject *set);
TQ3Status Q3Shape_SetSet(TQ3ShapeObject shape, TQ3SetObject set);

Managing Strings

TQ3ObjectType Q3String_GetType(TQ3StringObject stringObj);
TQ3StringObject Q3CString_New(const char *string);
TQ3Status Q3CString_GetLength(TQ3StringObject stringObj, 
unsigned long *length);
TQ3Status Q3CString_GetString(TQ3StringObject stringObj, 
char **string);
TQ3Status Q3CString_SetString(TQ3StringObject stringObj, 
const char *string);
TQ3Status Q3CString_EmptyData(char **string);

Errors, Warnings, and Notices

kQ3ErrorInternalError
kQ3ErrorNoRecovery
kQ3ErrorNotInitialized
kQ3ErrorAlreadyInitialized
kQ3ErrorUnimplemented
kQ3ErrorRegistrationFailed
kQ3ErrorMemoryLeak
kQ3ErrorOutOfMemory
kQ3ErrorNULLParameter
kQ3ErrorParameterOutOfRange
kQ3ErrorInvalidParameter
kQ3ErrorInvalidData
kQ3ErrorAcceleratorAlreadySet
kQ3ErrorInvalidObject
kQ3ErrorInvalidObjectType
kQ3ErrorInvalidObjectName
kQ3ErrorObjectClassInUse
kQ3ErrorAccessRestricted
kQ3ErrorMetaHandlerRequired
kQ3ErrorNeedRequiredMethods
kQ3ErrorNoSubClassType
kQ3ErrorUnknownElementType
kQ3ErrorNotSupported
kQ3ErrorNoExtensionsFolder
kQ3ErrorExtensionError
kQ3ErrorPrivateExtensionError
kQ3ErrorBadStringType
kQ3WarningInternalException
kQ3WarningNoObjectSupportForDuplicateMethod
kQ3WarningNoObjectSupportForWriteMethod
kQ3WarningNoObjectSupportForReadMethod
kQ3WarningNoObjectSupportForDrawMethod
kQ3WarningUnknownElementType
kQ3WarningTypeAndMethodAlreadyDefined
kQ3WarningTypeIsOutOfRange
kQ3WarningTypeHasNotBeenRegistered
kQ3WarningInvalidSubObjectForObject
kQ3WarningInvalidHexString
kQ3WarningUnknownObject
kQ3WarningInvalidTableOfContents
kQ3WarningUnresolvableReference
kQ3WarningNoAttachMethod
kQ3WarningInconsistentData
kQ3WarningLowMemory
kQ3WarningPossibleMemoryLeak
kQ3NoticeDataAlreadyEmpty
kQ3NoticeMethodNotSupported
kQ3NoticeObjectAlreadySet